package com.kly.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.kly.domain.dto.space.SpaceAddRequest;
import com.kly.domain.dto.space.SpaceQueryRequest;
import com.kly.domain.entity.Space;
import com.kly.domain.entity.User;
import com.kly.domain.vo.space.SpaceVO;

import javax.servlet.http.HttpServletRequest;

/**
 * @author admin
 * @description 针对表【space(空间)】的数据库操作Service
 * @createDate 2025-03-11 12:40:49
 */
public interface SpaceService extends IService<Space> {

    /**
     * 获取查询的 queryWrapper
     *
     * @param spaceQueryRequest 图片请求类
     * @return 可用来查询的 queryWrapper
     */
    QueryWrapper<Space> getQueryWrapper(SpaceQueryRequest spaceQueryRequest);


    /**
     * 获取单个图片的 VO 对象
     *
     * @param space space 对象
     * @param request request 请求
     * @return 对应图片的 VO
     */
    SpaceVO getSpaceVO(Space space, HttpServletRequest request);


    /**
     * 校验图片参数
     */
    void validateSpaceInfo(Space space);


    /**
     * 返回图片的 VO 对象 page
     */
    Page<SpaceVO> listSpaceVOByPage(Page<Space> page);


    /**
     * 根据空间等级 自动填充剩余信息
     */
    void fillSpaceInfo(Space space);


    /**
     * 新增空间
     */
    Long addSpace(SpaceAddRequest spaceAddRequest, User loginUser);


}
